讓 AI 先讀懂資料夾，再開始動手

文章草稿，待作者實測。前置：Day 02 的兩份文件、可啟動的 Claude Code。

今天遇到的問題

如果一開始就說「幫我完成股票研究工具」，AI 可能直接建立很多檔案。對新手來說，結果越多不一定越容易理解。我想先知道：它到底讀了什麼，哪些內容是檔案證據，哪些只是推測？

一個核心概念：依據檔案回答

檔案提到「未來要支援 SQLite」，不表示現在已經有資料庫。看專案時，要區分需求、實作、測試與輸出；這個習慣會一路用到全市場資料完整度檢查。

實作：只讀的專案地圖

在工作台啟動 Claude Code，貼上：

先閱讀 project-goal.md 與 docs/PROJECT-BRIEF.md。
今天只讀，不建立或修改檔案，不安裝套件，不連線查股價。
請列出：
1. 目前實際存在的文件或程式。
2. 規格希望有、但尚未實作的功能。
3. 從需求無法判定、需要之後驗證的事情。
每項指出檔名；找不到證據就寫「尚未確認」。
最後用我能理解的文字說明今天的資料夾用途。

把回答和自己看到的資料夾核對。確認沒有憑空多出 API、網站或資料表後，把整理好的內容自行保存成 docs/project-map.md。

可以追問：「你說有研究報告功能，證據是程式，還是只有規格？」這不是挑錯，而是在建立自己的檢查方法。

一個失敗案例

AI 讀到規格裡的 research report 就說「執行這個指令即可」，但指令尚未實作。請它重新標示 planned 和 implemented，並說明如何判斷。

當日驗收

• [ ] 專案地圖能對應實際檔案。
• [ ] 計畫中的五個 CLI 沒被誤寫成已完成。
• [ ] 找到至少一項需要未來實測的前提。

實測後補：

• 環境：Windows 11、Claude Code 2.1.268。
• 前置狀態：Day 02 的 project-goal.md、docs/PROJECT-BRIEF.md。
• 今天的問題：只讀掃描專案，分清「已存在」「規格未實作」「待驗證」三類。
• 實際 prompt：教材 Day 04 提供的完整 prompt（先閱讀 project-goal.md 與 docs/PROJECT-BRIEF.md，今天只讀……）。
• 執行指令：Read 兩份檔案、Write docs/project-map.md（未執行任何安裝或連線動作）。
• 觀察結果與退出碼：成功產出三段分析＋資料夾用途說明。
• 產物位置：docs/project-map.md。
• 與教學預期的差異：無，PROJECT-BRIEF.md 本身就明確標示規格待實作項目，掃描結果與規格內容一致。
• 失敗原因與修正：無。
• 截圖檔名：無。
• 本日總時間：約 6 分鐘。
• 文章要調整的段落：無。
• 尚未驗證：stock-analysis-lab 引擎目前版本是否真的支援 PROJECT-BRIEF 描述的行為，這點寫進了 project-map.md 的「待驗證」清單，需要作者對照引擎專案本身確認。
• 我的心得：這步驟的價值在於强制列出「規格 ≠ 實作」，避免之後把 PROJECT-BRIEF.md 的願景當成現況。

下一天預告

明天把願望改寫成具體任務，讓 AI 的成果可以被驗收。